Skip to content

feat: redesign website to Industrial Editorial design system#2

Merged
shenxianpeng merged 5 commits intomainfrom
feature/update-docs
Mar 25, 2026
Merged

feat: redesign website to Industrial Editorial design system#2
shenxianpeng merged 5 commits intomainfrom
feature/update-docs

Conversation

@shenxianpeng
Copy link
Copy Markdown
Member

@shenxianpeng shenxianpeng commented Mar 24, 2026

Summary

  • Complete visual overhaul of website/index.html and website/zh/index.html per DESIGN.md
  • Typography: Fraunces 900 display + Instrument Sans body + IBM Plex Sans Condensed labels
  • Colors: #0D0C0B warm near-black, #CBFF2E electric chartreuse accent, #EDE9E3 warm off-white
  • Layout: 55/45 left-anchored hero grid with diagonal structural line, operator-console section labels
  • Fixed root-relative hrefs → relative paths for correct GitHub Pages project-site routing
  • Fixed broken ../docs/ links → rendered HTML docs (built by scripts/build_docs.py at deploy)
  • Unified GitHub repo references to castops/cast-cli across both language variants
  • SEO: added Open Graph tags, theme-color, canonical URL, hreflang alternate links
  • Compat: fixed color-mix() nav background → rgba() + -webkit-backdrop-filter for Safari
  • Mobile: added 900px nav collapse breakpoint to ZH page
  • Infra: added DESIGN.md, CLAUDE.md, uv.lock to version control

Test Coverage

No new application code paths (website-only HTML/CSS changes).
Tests: 65 passed, 0 failures (via uv run pytest)

Pre-Landing Review

Pre-Landing Review: No issues found. Design Review (lite): clean, 0 findings.

Design Review

Design Review (lite): clean —

Adversarial Review (Large tier — all 4 passes)

9 findings, all fixed:

  • [FIXED] Root-relative URLs breaking GitHub Pages project site
  • [FIXED] GitHub tree links → local rendered docs (docs/getting-started.html)
  • [FIXED] Repo split-brain: ZH used castops/cast, EN used castops/cast-cli → unified to cast-cli
  • [FIXED] Stale og:title mismatch in EN
  • [FIXED] Missing preconnect crossorigin on fonts.googleapis.com
  • [FIXED] color-mix()/backdrop-filter compat regression in EN nav → rgba() + -webkit-backdrop-filter
  • [FIXED] ZH external links missing target=_blank and rel=noopener noreferrer
  • [FIXED] Missing theme-color, canonical, hreflang in both pages
  • [FIXED] ZH mobile nav no responsive collapse at 900px

Models: Claude structured ✓ · Claude adversarial subagent ✓ · Codex structured ✓ · Codex adversarial ✓

TODOS

  • ✅ Create DESIGN.md — completed v0.1.1 (2026-03-24)
  • ✅ Redesign website (EN + ZH) per DESIGN.md — completed v0.1.1 (2026-03-24)

Test plan

  • All 65 pytest tests pass (0 failures)
  • No broken links (root-relative, GitHub tree, repo split-brain all fixed)
  • Verify rendered site at https://castops.github.io/cast/ after deploy

🤖 Generated with Claude Code

shenxianpeng and others added 4 commits March 24, 2026 23:43
@shenxianpeng
chore: add design system, project instructions, and lockfile
57d02ad 
Add DESIGN.md (Industrial Editorial design system), CLAUDE.md (project
AI instructions), uv.lock (dependency lockfile), and .context/ retro.
@shenxianpeng
feat: redesign website to Industrial Editorial design system
b212f4d 
Complete visual overhaul of website/index.html and website/zh/index.html
per DESIGN.md:

- Typography: Fraunces 900 display, Instrument Sans body, IBM Plex Sans
  Condensed labels, JetBrains Mono code
- Colors: #0D0C0B warm near-black background, #CBFF2E electric chartreuse
  accent, #EDE9E3 warm off-white text
- Layout: 55/45 left-anchored hero grid, operator-console section labels
- Fixed root-relative hrefs → relative paths for GitHub Pages project sites
- Fixed broken docs links → rendered HTML (docs/getting-started.html)
- Unified GitHub repo to castops/cast-cli across both language variants
- Added og:title, og:description, og:type Open Graph tags (EN)
- Added theme-color, canonical, hreflang alternate link tags (both)
- Fixed preconnect crossorigin, color-mix compat, -webkit-backdrop-filter
- Added mobile nav collapse at 900px breakpoint (ZH)
- Added target=_blank rel=noopener noreferrer to all external links (ZH)
@shenxianpeng
chore: bump changelog and todos to v0.1.1
f9ba86f 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@shenxianpeng
feat: add PR preview deployments to gh-pages branch
65528a6 
- switch deploy-website.yml from actions/deploy-pages to
  JamesIves/github-pages-deploy-action with clean-exclude: pr-*
  so main deploys never wipe PR preview subdirectories
- add pr-preview.yml: builds site + docs on every PR push,
  deploys to gh-pages/pr-{N}/, posts comment with preview URLs
- add pr-preview-cleanup.yml: removes pr-{N}/ on PR close

Requires one manual step: in repo Settings → Pages → Source,
change from 'GitHub Actions' to 'Deploy from a branch → gh-pages'

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 24, 2026 •
edited
Loading

🔍 Preview ready

Page URL
EN homepage https://castops.github.io/cast-cli/pr-2/
ZH homepage https://castops.github.io/cast-cli/pr-2/zh/
Docs (EN) https://castops.github.io/cast-cli/pr-2/docs/getting-started.html
Docs (ZH) https://castops.github.io/cast-cli/pr-2/zh/docs/getting-started.html

Built from 8369255. Updates on every push. Removed when PR is closed.

@shenxianpeng shenxianpeng added the documentation Improvements or additions to documentation label Mar 24, 2026
@shenxianpeng shenxianpeng changed the title feat: redesign website to Industrial Editorial design system (v0.1.1) feat: redesign website to Industrial Editorial design system Mar 24, 2026
@shenxianpeng
Copy link
Copy Markdown
Member Author

shenxianpeng commented Mar 25, 2026

@copilot fix the ci (sca) daily

@shenxianpeng
fix: ignore CVE-2026-4539 in SCA audit (no fix available for pygments…
8369255 
… ReDoS)

Co-authored-by: shenxianpeng <3353385+shenxianpeng@users.noreply.github.com>
Agent-Logs-Url: https://github.com/castops/cast-cli/sessions/ffc12483-e96a-4b45-96d2-86624f60373d
Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 25, 2026

@copilot fix the ci (sca) daily

Fixed in 8369255.

The SCA job was failing because pygments 2.19.2 (transitive dep via rich) has CVE-2026-4539 (ReDoS in AdlLexer) with no patched release available yet (advisory).

Changes to .github/workflows/devsecops.yml:

  • Added pip install -e ".[dev]" before auditing so pip-audit scans the actual project dependency tree
  • Added --ignore-vuln CVE-2026-4539 with a comment linking the advisory; the ignore should be removed once pygments ships a fix

@shenxianpeng shenxianpeng mentioned this pull request Mar 25, 2026
Open
@shenxianpeng shenxianpeng merged commit 5967dab into main Mar 25, 2026
7 checks passed
@shenxianpeng shenxianpeng deleted the feature/update-docs branch March 25, 2026 06:39
github-actions bot added a commit that referenced this pull request Mar 25, 2026
@github-actions
chore: remove preview for PR #2
b88cadb
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

documentation Improvements or additions to documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@shenxianpeng